home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 #1 / Ham Radio 2000.iso / ham2000 / tcp_ip / watchdog / watchdog.doc < prev    next >
Encoding:
Text File  |  1992-01-24  |  6.4 KB  |  146 lines
  1. PROGRAM   : Watchdog
  2. AUTHOR    : Clifford K. Yamamoto (KA6JRG)
  3. DATE      : Jan 5, 1992
  4. VERSION   : 1.2
  5. REQUIRES  : DOS 2.0 or later, PC/XT/AT/386/486 or compatible, CGA/EGA/VGA
  6. FUNCTION  : Warmboots your computer after a user defined X-Y location on
  7.             the screen doesn't change before a given timeout.
  8.  
  9.  
  10. ** The Problem **
  11.  
  12.   For those who are not fortunate to have their AA4RE based BBS system(s)
  13. nearby, remote configuration is often the only alternative.  This usually
  14. leads to the use of the "EX DOS" command to briefly execute a DOS command
  15. or utility program while reconfiguring.
  16.  
  17.   If you fall into this category how often have you executed a program or
  18. misstyped a command parameter only to have the BBS lockup since the shell
  19. to DOS would never return?  Here are some typical examples:
  20.                 
  21.     EX DOS DATE                 (DOS will wait until you enter a new date)
  22.     EX DOS EDLIN                (You can't quit EDLIN without hitting 'Q')
  23.     EX DOS PKUNZIP STUFF.ZIP    (There is a file in STUFF.ZIP that already
  24.                                  exists so PKUNZIP gives you a warning and
  25.                                  then asks 'Overwrite (y/n)?')
  26.  
  27.   As you can tell, executing a DOS function or a program that halts until
  28. user input is received is catastrophic since the BBS cannot regain control
  29. until the command shell is terminated.
  30.  
  31.  
  32. ** A solution **
  33.  
  34.   The answer to this problem is a little program I wrote called Watchdog.
  35. Although Watchdog cannot possibly know what keys to press for the correct
  36. time or which keys terminate your favorite editor, Watchdog does know how
  37. to perform a warmboot.
  38.  
  39.   Watchdog will only perform a warmboot when screen activity at a user
  40. defined X (column) & Y (row) location ceases to change before the timeout
  41. value is arrived.
  42.  
  43.  
  44. ** Usage **
  45.  
  46.   Although this program was originally written for use with the AA4RE BBS
  47. program, it may have other uses in remote operating systems.  In our case
  48. here at the JPL Amateur Radio Club,  we have our BBS running on lab which
  49. is a twenty minute drive for the nearest club member.
  50.  
  51.   By just typing 'watchdog' at the DOS prompt, it will prompt you for the
  52. necessary parameters as follows :
  53.  
  54.     USAGE: watchdog <column> <row> <timeout>
  55.  
  56.   For example, your 'autoexec.bat' file may contain the following line :
  57.  
  58.     watchdog 18 6 180
  59.  
  60.   This means Watchdog will watch the character in the 18th column and the
  61. 6th row to change before 180 seconds elapses.  If this character does not
  62. change before then, Watchdog will warmboot the computer.  However, if the
  63. character does change before the timeout,  Watchdog will wait for another
  64. 180 seconds unless the character changes again.  In the case of the AA4RE
  65. BBS, this location happens to be the first digit of the minutes display.
  66.  
  67.   Although 60 seconds would be the expected value, you'll never know when
  68. you may 'EX DOS' a command that might take longer than 60 seconds.   Also
  69. it is possible the BBS may be busy starting an 'action' or other activity
  70. so that the time display is updated a second or two late.
  71.  
  72.   The value you decide to use should be based on how often the character
  73. changes and if there are any anticipated situations when a longer timeout
  74. is required during maintanence  (you wouldn't want the computer to reboot
  75. while you were editing a file at the keyboard; unless you continue typing
  76. so the character at your chosen X-Y changes before the timeout).
  77.  
  78.  
  79. ** Tidbits and limitations **
  80.  
  81. > Watchdog checks the screen location 18 times a second.  If text at the
  82.   location changes too fast, Watchdog may miss it.
  83.  
  84. > Watchdog does not work with the MDA (Monochrome Display Adapter) or the
  85.   HGC (Hercules Graphics Card).
  86.  
  87. > Watchdog does not check the parameters you provide for resonable values.
  88.   If you enter X > 80 and Y > 50 Watchdog may be watching video memory in
  89.   strange areas.
  90.  
  91. > Watchdog stays resident.  If you need to load and remove Watchdog on a
  92.   regular basis, you may want to use the 'TsrCom' utilities "mark" and
  93.   "release".  These utilities allow you to load and unload TSRs.
  94.  
  95. > Watchdog can be loaded multiple times.  This may be an advantage if you
  96.   need to make sure TWO or more screen locations are changing within their
  97.   allotted time limits.
  98.  
  99. > Watchdog can usually carry out it's duties so long as your computer is
  100.   not completely locked up where even a Ctl-Alt-Del won't work.  If your
  101.   program does enter a state like this, Watchdog may not be able to help
  102.   you.
  103.  
  104.  
  105. ** Legalities, etc. **
  106.  
  107.   This software is FREE FREE FREE FREE FREE!!  I don't want money for it
  108. and I don't want anyone to be charged for it.  Go ahead and copy this as
  109. much as you like and pass it around.  Just DO NOT charge anybody for it.
  110. Also this software is not copyrighted or anything, but please don't go
  111. around telling others you wrote it.
  112.  
  113.   Now the liabilites.  I am NOT RESPONSBILE for any time, data, money,
  114. equipment, friends, etc. that is/are lost for using this program.  This
  115. software is offered as is.  You assume all responsibility for using it.
  116. I am NOT RESPONSIBLE for any negligent or deliberate misuse of this
  117. program.  You use this program at your OWN RISK!  I make no guarantees
  118. about its reliability, stability, compatibility or operation with your
  119. particular computer or your software.
  120.  
  121.  
  122. ** Feedback about Bugs, Features, etc. **
  123.  
  124.   I welcome feedback about Watchdog.  If you have a comment, good or bad,
  125. I'll will try to respond.  This program was written in my spare time so I
  126. may not always be available.  As this software is free I DO NOT have any
  127. customer support whatsoever.  If you cannot resolve a problem, ask around
  128. and/or try out the program on another computer.
  129.  
  130.   If you feel you have found a genuine bug, please report it to me to one
  131. of the email addresses below.  Please tell me the configuration of your
  132. computer and what software, plus version numbers, you were running.
  133.  
  134.   About features.  This program was meant to be small and simple.  If you
  135. really need support for MDA/HGC, let me know.  It can be added if there is
  136. enough interest for it.  Also if you'd like to see some other feature added,
  137. let me know.
  138.  
  139. I can be reached at :
  140.  
  141. Internet: cky@euclid.Jpl.Nasa.Gov
  142. Bitnet:      cky%euclid.Jpl.Nasa.Gov@Hamlet.Bitnet
  143. Uucp:     uunet!euclid.Jpl.Nasa.Gov!cky@uunet.UU.NET
  144.           ames!elroy!jato!jpl-mil!euclid.jpl.nasa.gov!cky
  145. Packet:   KA6JRG@W6VIO.#SOCA.CA.USA.NA
  146.